--- /dev/null
+st2gpx - Export/import data from MS Streets & Trips, Autoroute and Mappoint files to GPX format\r
+\r
+By James Sherring, james_sherring@yahoo.com\r
+\r
+********************************************************************************************\r
+\r
+WARNING \r
+*******\r
+ms2gpx could corrupt Microsoft Streets & Trips, Autoroute and Mappoint files.\r
+ms2gpx is based on my (James Sherring) limited understanding and guessing of Microsoft file formats.\r
+These file formats are undocumented, vary between products and versions, and certainly have information\r
+that I do not understand. \r
+\r
+There is no guarantee that this program will work correctly. \r
+It is possible that it will import or export data erroneously,\r
+corrupt your data files, \r
+that files modified by st2gpx will crash applications using them,\r
+or that there will be other loss of data or other effects.\r
+\r
+It is recommended that you backup any data before using this program.\r
+\r
+Usage of this program indicates that you understand this risk and assume all responsibility for your data.\r
+\r
+********************************************************************************************\r
+\r
+Usage: st2gpx [-hr] [-v verbose-level] [-g gpx-in-file] [-G gpx-out-file] \r
+ [-m mpst-in-file] [-M pcx5-out-file] [-F st-mod-file] stfile\r
+\r
+-h : Help (this text)\r
+-r : Export drawn-lines as routes instead of tracks\r
+-g gpx-in-file : Import data from GPX XML format gpx-in-file\r
+-G gpx-out-file : Write output to GPX XML format gpx-out-file\r
+-F st-mod-file : Write modified stfile with imported data\r
+ to (new) st-mod-file.\r
+-m mpst-in-file : Import data from Garmin MapSource text-export mpst-in-file\r
+-M pcx5-out-file : Write output to Garmin MapSource importable pcx5-out-file\r
+\r
+export hint: st2gpx stfile (or use drag & drop)\r
+import hint: st2gpx -g gpx-in-file -F st-mod-file st-template-file\r
+\r
+Debugging options:\r
+-e : Explore data further\r
+-v [n] : Set debugging verbosity to 'n' (0-6, default 2)\r
+-u userdata-file : Process pushpins in (mdb) file userdata-file\r
+-j journey-file : Process Journey in file journey-file\r
+-a annotations-file : Process Annotations in file annotations-file\r
+-p properties-file : Analyse OLE properties-file\r
+\r
+\r
+FAQ\r
+---\r
+\r
+Q What is st2gpx for?\r
+\r
+A I wanted to draw tracks from my GPS in Autoroute to see where I had been. \r
+ And I wanted to download data from Autoroute to my GPS.\r
+\r
+ st2gpx is used for converting data in Microsoft Map (Streets & Trips, Autoroute and Mappoint) format\r
+ to a usable data format. GPX is becoming the standard format for GPS data. GPSBabel can convert GPX data \r
+ into many other data formats.\r
+ \r
+\r
+Q Is there a GUI version?\r
+\r
+A Sorry, not yet.\r
+ \r
+ \r
+Q What can st2gpx do that you cant do with import/export in Microsoft Map (Streets & Trips, Autoroute and Mappoint)?\r
+\r
+A st2gpx can import and export poly-lines. Streets & Trips and Autoroute cant do this, and Mappoint needs \r
+ to be programmed to achieve this. Normally Streets & Trips and Autoroute only import pushpins.\r
+ (st2gpx can also import/export pushpins and export the driving route.) \r
+\r
+\r
+Q How do I save a GPS track or other GPX data from Streets & Trips, Autoroute or Mappoint?\r
+\r
+A First create the data you want in Streets & Trips, Autoroute or Mappoint.\r
+ This can include pushpins, route, and poly-lines. It does not include driving instructions or drawing shapes \r
+ other than poly-lines.\r
+ Then the command is:\r
+ st2gpx input-file-name \r
+ input-file-name is your existing Streets & Trips, Autoroute or Mappoint file; \r
+ The data will be exported into a file of the same name with the extension .gpx \r
+ (you can specify the name of the output file with the -G option)\r
+ You can use GPSBabel or other programs with this data.\r
+\r
+\r
+Q How do I import a GPS track or other GPX data into Streets & Trips, Autoroute or Mappoint?\r
+\r
+A First you need to have the data in GPX format - see GPSBabel for that.\r
+ Then you need to chose your import file, it can me an empty map or one with your existing data in it. \r
+ Be sure to backup this file! Then the command is:\r
+ st2gpx -g gpx-in-file -F output-file-name input-file-name\r
+ where gpx-in-file must be a valid GPX file; input-file-name is your existing Streets & Trips, \r
+ Autoroute or Mappoint file; and output-file-name is the new Streets & Trips, Autoroute or Mappoint file.\r
+ GPS routes and tracks will be drawn as blue poly-lines, and waypoints will be imported as pushpins.\r
+\r
+ \r
+Q I would like to get the driving instructions, and detailed route, but st2gpx only saves the start/end and stops.\r
+\r
+A Unfortunately, the driving instructions are not saved in the file. You can add extra stops after the route \r
+ is calculated, or you can draw/trace a poly-line along the route calculated by Streets & Trips/Autoroute/Mappoint.\r
+ This is exported as a track (or optionally a route), and can then be loaded to your GPS receiver \r
+ using the correct software. I use an older Garmin GPS12 and loading a track this way works very well.\r
+\r
+ \r
+Q How do I draw/trace a poly-line along the route?\r
+\r
+A You need to use the drawing toolbar. There are many different line types, but I find 'freeform' the best.\r
+ Begin with the entire route in view (or the part that you want to trace) and mark out the major points. \r
+ Then you can zoom in and add more detail by adding points or correct points by dragging them.\r
+ I find it best to add points at significant turns or intersections, and perhaps an extra point or two\r
+ near the intersection so the line direction of approach or exit from the intersection is accurate.\r
+ You can add many more points to get a very detailed trace of the route, but that may not be necessary.\r
+ Experiment, and see what works for you.\r
+ \r
projects / gpsbabel.git / commitdiff